7.1 Setting configuration options within the MyID Client for Mac

To set the configuration options:

  1. Select the Configuration option.

    The configuration screen appears.

  2. Scroll to the appropriate section and set the relevant options.

    Note: Your administration may have restricted your ability to change some or all of your configuration options.

  3. Click Apply Changes.

    To revert to the previous settings, click Revert Changes.

    To go back without making any changes, click Back.

7.1.1 Administrator-configured options

Your administrator may have set up a configuration override file that provides default values or prevents you from changing values; see section 7.2, Setting up an administrator configuration override file.

The MyID Client for Mac displays icons next to the option fields for administrator-configured options:

Icon

Description

The value was provided by an administrator configuration override file.

The value was provided by an administrator configuration override file, and the current value is different from the administrator-provided value; click the icon to revert to the administrator-configured value.

7.1.2 Setting communication options

To set the communication options:

  1. Select the Configuration option.

    Communication options

  2. In the Communication section, set the following options:

    • Server Address – type the address of the MyID web services server.

      For example:

      https://myid.example.com

      Note: You must start the server address with https://.

    • Client ID – optionally, type a unique identifier that the MyID Client for Mac uses to identify itself to the server.

      You can capture this information in the audit to determine which workstation originated a request. See the Logging the client IP address and identifier section in the Administration Guide for details.

    • Culture (IETF Language Tag) – provide an IETF language tag (for example, en-US) that overrides the default behavior of using the language culture setting of the operating system; for example, you may have a UK English system but want to display the MyID Client for Mac interface in US English.

  3. Click Apply Changes.

Note: For these settings to take effect, you must restart the MyID Client for Mac.

7.1.3 Setting authentication options

To set the authentication options:

  1. Select the Configuration option.

    Authentication options

  2. In the Authentication section, set the following options:

    • Username – optionally, type the username you want to the MyID Client for Mac to use each time you start it up.

    • Enable 'Remember Me' – select this option to allow users to store their username between sessions.

  3. Click Apply Changes.

Note: For these settings to take effect, you must restart the MyID Client for Mac.

7.1.4 Setting logging options

To set the logging options:

  1. Select the Configuration option.

    Logging options

  2. In the Logging section, set the following options:

    • Enable Log File – select this option to enable logging.

    • Verbose Web Service Logging – select this option to log all network communication with MyID. You are recommended to use this only for diagnostics, as it may result in sensitive information being included in the logs.

    • Log File Location – type the location to which you want to write the log file.

    • Smart Card log file location – type the location to which you want to write the smart card log file.

      Smart card log events are stored separately from general log events.

    • In-Memory Log Retention Duration (Minutes) – type the number of minutes of log entries to retain in memory. This log is used for just-in-time error reports. After the configured number of minutes, log events are discarded. By default, reports contain the last 30 minutes of log entries.

  3. Click Apply Changes.

You can also generate a just-in-time log when an error occurs; this does not require logging to be enabled, but is always available.

To generate a just-in-time error report:

  1. Carry out an operation that generates an error.

    Generate error report

  2. Click Generate Error Report.

  3. Select the folder into which you want to write the report, then click Open.

  4. Click OK.

7.1.5 Setting accessibility options

You can set the page timeout for the MyID Client for Mac screens. The page timeout is used for security reasons; for example, when setting a new PIN for your device. You may want to increase the timeout value if, for example, you are using a screen reader that increases the time it takes to use the screen.

To change the page timeout:

  1. Select the Configuration option.

  2. In the Accessibility section, set the following option:

    • Page Timeout – type the number of seconds that you want to allow before the page times out.

  3. Click Apply Changes.

Note: For this setting to take effect, you must restart the MyID Client for Mac.

7.1.6 Setting advanced options

You can set advanced configuration options for which there is no dedicated field on the configuration screen.

For example, if you are using a version of MyID CMS earlier than 12.11, you must set the UseLegacySsaPlatform configuration option to true to allow the MyID Client for Mac to impersonate the Self-Service App and be recognized by the server.

To set a custom configuration option:

  1. Select the Configuration option.

    Advanced options

  2. In the Advanced Configuration section, type a Key and a Value for the option.

    For example:

    • Key – UseLegacySsaPlatform

    • Value – true

  3. Click Add.

  4. Click Apply Changes.

7.1.7 Accessing configuration options from the Terminal

The MyID Client for Mac configuration options are stored under com.intercede.myidclient in the user's defaults registry.

To view the configuration options for the current user, at the Terminal, type:

defaults read com.intercede.myidclient

To write a user setting, type:

defaults write com.intercede.myidclient MyCustomKey MyValue

To delete all user settings for the current user, type:

defaults delete com.intercede.myidclient